home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtSetKeyboardFocus.z / XtSetKeyboardFocus
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttSSSSeeeettttKKKKeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussss((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttSSSSeeeettttKKKKeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussss((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtSetKeyboardFocus - focus events on a child widget
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           XtSetKeyboardFocus(_s_u_b_t_r_e_e, _d_e_s_c_e_n_d_a_n_t)
  13.                Widget _s_u_b_t_r_e_e, _d_e_s_c_e_n_d_a_n_t;
  14.  
  15.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  16.           _d_e_s_c_e_n_d_a_n_t
  17.                     Specifies either the widget in the subtree
  18.                     structure which is to receive the keyboard event,
  19.                     or _N_o_n_e.  Note that it is not an error to specify
  20.                     _N_o_n_e when no input focus was previously set.
  21.  
  22.           _s_u_b_t_r_e_e   Specifies the widget for which the keyboard focus
  23.                     is to be set.
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           If a future _K_e_y_P_r_e_s_s or _K_e_y_R_e_l_e_a_s_e event occurs within the
  27.           specified subtree, _X_t_S_e_t_K_e_y_b_o_a_r_d_F_o_c_u_s causes _X_t_D_i_s_p_a_t_c_h_E_v_e_n_t
  28.           to remap and send the event to the specified descendant
  29.           widget.
  30.  
  31.           When there is no modal cascade, keyboard events can occur
  32.           within a widget W in one of three ways:
  33.  
  34.           +o    W has the X input focus.
  35.  
  36.           +o    W has the keyboard focus of one of its ancestors, and
  37.                the event occurs within the ancestor or one of the
  38.                ancestor's descendants.
  39.  
  40.           +o    No ancestor of W has a descendant within the keyboard
  41.                focus, and the pointer is within W.
  42.  
  43.           When there is a modal cascade, a widget W receives keyboard
  44.           events if an ancestor of W is in the active subset of the
  45.           modal cascade and one or more of the previous conditions is
  46.           _T_r_u_e.
  47.  
  48.           When subtree or one of its descendants acquires the X input
  49.           focus or the pointer moves into the subtree such that
  50.           keyboard events would now be delivered to subtree, a _F_o_c_u_s_I_n
  51.           event is generated for the descendant if _F_o_c_u_s_N_o_t_i_f_y events
  52.           have been selected by the descendant.  Similarly, when W
  53.           loses the X input focus or the keyboard focus for one of its
  54.           ancestors, a _F_o_c_u_s_O_u_t event is generated for descendant if
  55.           _F_o_c_u_s_N_o_t_i_f_y events have been selected by the descendant.
  56.  
  57.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  58.           XtCallAcceptFocus(3Xt)
  59.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttSSSSeeeettttKKKKeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussss((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttSSSSeeeettttKKKKeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussss((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.